home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / cmds / gdb.new / gdb-4.0 / bfd / doc / opncls.p < prev    next >
Encoding:
Text File  |  1991-09-29  |  1.7 KB  |  65 lines
  1. /* *i bfd_openr
  2. Opens the file supplied (using @code{fopen}) with the target supplied, it
  3. returns a pointer to the created BFD.
  4.  
  5. If NULL is returned then an error has occured.
  6. Possible errors are no_memory, invalid_target or system_call error.
  7. */
  8.  PROTO(bfd*, bfd_openr, (CONST char *filename,CONST char*target));
  9.  
  10. /*
  11.  
  12. *i bfd_fdopenr
  13. bfd_fdopenr is to bfd_fopenr much like  fdopen is to fopen. It opens a BFD on
  14. a file already described by the @var{fd} supplied. 
  15.  
  16. Possible errors are no_memory, invalid_target and system_call error.
  17. */
  18.   PROTO(bfd *, bfd_fdopenr,
  19.     (CONST char *filename, CONST char *target, int fd));
  20.  
  21. /*
  22.  
  23.  bfd_openw
  24. Creates a BFD, associated with file @var{filename}, using the file
  25. format @var{target}, and returns a pointer to it.
  26.  
  27. Possible errors are system_call_error, no_memory, invalid_target.
  28. */
  29.  PROTO(bfd *, bfd_openw, (CONST char *filename, CONST char *target));
  30.  
  31. /*
  32.  
  33.  bfd_close
  34. This function closes a BFD. If the BFD was open for writing, then
  35. pending operations are completed and the file written out and closed.
  36. If the created file is executable, then @code{chmod} is called to mark
  37. it as such.
  38.  
  39. All memory attached to the BFD's obstacks is released. 
  40.  
  41. @code{true} is returned if all is ok, otherwise @code{false}.
  42. */
  43.  PROTO(boolean, bfd_close,(bfd *));
  44.  
  45. /*
  46.  
  47.  bfd_create
  48. This routine creates a new BFD in the manner of @code{bfd_openw}, but without
  49. opening a file. The new BFD takes the target from the target used by
  50. @var{template}. The format is always set to @code{bfd_object}.
  51. */
  52.  
  53.  PROTO(bfd *, bfd_create, (CONST char *filename, bfd *template));
  54.  
  55. /*
  56.  
  57.  bfd_alloc_size
  58. Return the number of bytes in the obstacks connected to the supplied
  59. BFD.
  60. */
  61.  PROTO(bfd_size_type,bfd_alloc_size,(bfd *abfd));
  62.  
  63. /*
  64. */
  65.